home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / rzsz9107.zip / SZ.DOC < prev    next >
Text File  |  1991-07-03  |  18KB  |  463 lines
  1.  
  2.  
  3.  
  4.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       sx, sb, sz - XMODEM, YMODEM, ZMODEM file send
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       sz [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppqqqqTTTTttttuuuuvvvvyyyyYYYYZZZZ] _f_i_l_e ...
  13.       sb [-aaaaddddffffkkkkqqqqttttuuuuvvvv] _f_i_l_e ...
  14.       sx [-aaaakkkkqqqqttttuuuuvvvv] _f_i_l_e
  15.       sz [-ooooqqqqttttvvvv] ----cccc    CCCCOOOOMMMMMMMMAAAANNNNDDDD
  16.       sz [-ooooqqqqttttvvvv] ----iiii    CCCCOOOOMMMMMMMMAAAANNNNDDDD
  17.       sz -TT
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       SSSSzzzz uses the ZMODEM, YMODEM or    XMODEM error correcting
  21.       protocol to send one or more files over a dial-in serial
  22.       port to a variety of programs    running    under PC-DOS, CP/M,
  23.       Unix,    VMS, and other operating systems.
  24.  
  25.       Commercial use of this program is subject to licensing
  26.       conditions detailed in the rz.c source code.    "Commercial
  27.       Use" includes    support    of shareware programs not published by
  28.       Omen Technology INC.
  29.  
  30.  
  31.       This program is not designed to be called from _c_u(_1) or
  32.       other    communications programs.  Unix flavors of Omen
  33.       Technology's Professional-YAM    communications software    are
  34.       available for    dial-out applications.
  35.  
  36.  
  37.       SSSSzzzz sends one or more files with ZMODEM protocol.
  38.  
  39.       ZMODEM greatly simplifies file transfers compared to XMODEM.
  40.       In addition to a friendly user interface, ZMODEM provides
  41.       Personal Computer and    other users an efficient, accurate,
  42.       and robust file transfer method.
  43.  
  44.       ZMODEM provides complete EEEENNNNDDDD----TTTTOOOO----EEEENNNNDDDD data integrity between
  45.       application programs.     ZMODEM's 32 bit CRC catches errors
  46.       that sneak into even the most    advanced networks.
  47.  
  48.       Advanced file    management features include AutoDownload
  49.       (Automatic file Download initiated without user
  50.       intervention), Display of individual and total file lengths
  51.       and transmission time    estimates, Crash Recovery, selective
  52.       file transfers, and preservation of exact file date and
  53.       length.
  54.  
  55.       The ----yyyy option    instructs the receiver to open the file    for
  56.       writing unconditionally.  The    ----aaaa option causes the receiver
  57.       to convert Unix newlines to PC-DOS carriage returns and
  58.       linefeeds.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 7/3/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       SSSSbbbb batch sends one or    more files with    YMODEM or ZMODEM
  75.       protocol.  The initial ZMODEM    initialization is not sent.
  76.       When requested by the    receiver, ssssbbbb supports YYYYMMMMOOOODDDDEEEEMMMM----gggg with
  77.       "cbreak" tty mode, XON/XOFF flow control, and    interrupt
  78.       character set    to CAN (^X).  YYYYMMMMOOOODDDDEEEEMMMM----gggg (Professional-YAM gggg
  79.       option) increases throughput over error free channels
  80.       (direct connection, X.PC, etc.) by not acknowledging each
  81.       transmitted sector.
  82.  
  83.       On Unix systems, additional information about    the file is
  84.       transmitted.    If the receiving program uses this
  85.       information, the transmitted file length controls the    exact
  86.       number of bytes written to the output    dataset, and the
  87.       modify time and file mode are    set accordingly.
  88.  
  89.  
  90.       SSSSxxxx sends a single _f_i_l_e with XXXXMMMMOOOODDDDEEEEMMMM or    XXXXMMMMOOOODDDDEEEEMMMM----1111kkkk protocol
  91.       (sometimes incorrectly called    "ymodem").  The    user must
  92.       supply the file name to both sending and receiving programs.
  93.  
  94.       Iff sssszzzz is invoked with $SHELL    set and    iff that variable
  95.       contains the string _r_s_h or _r_k_s_h (restricted shell), sssszzzz
  96.       operates in restricted mode.    Restricted mode    restricts
  97.       pathnames to the current directory and PUBDIR    (usually
  98.       /usr/spool/uucppublic) and/or    subdirectories thereof.
  99.  
  100.  
  101.       The fourth form sends    a single COMMAND to a ZMODEM receiver
  102.       for execution.  SSSSzzzz exits with    the COMMAND return value.  If
  103.       COMMAND includes spaces or characters    special    to the shell,
  104.       it must be quoted.
  105.  
  106.  
  107.       The fifth form sends a single    COMMAND    to a ZMODEM receiver
  108.       for execution.  SSSSzzzz exits as soon as the receiver has
  109.       correctly received the command, before it is executed.
  110.  
  111.  
  112.       The sixth form (sz -TT) attempts to output all 256 code
  113.       combinations to the terminal.     In you    are having difficulty
  114.       sending files, this command lets you see which character
  115.       codes    are being eaten    by the operating system.
  116.  
  117.  
  118.       If sssszzzz    is invoked with    stdout and stderr to different
  119.       datasets, Verbose is set to 2, causing frame by frame
  120.       progress reports to stderr.  This may    be disabled with the qqqq
  121.       option.
  122.  
  123.       The meanings of the available    options    are:
  124.  
  125.       ++++    Instruct    the receiver to    append transmitted data    to an
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 7/3/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.            existing    file (ZMODEM only).
  141.       aaaa    Convert NL characters in    the transmitted    file to    CR/LF.
  142.            This is done by the sender for XMODEM and YMODEM, by
  143.            the receiver for    ZMODEM.
  144.       bbbb    (ZMODEM)    Binary override: transfer file without any
  145.            translation.
  146.       cccc CCCCOOOOMMMMMMMMAAAANNNNDDDD
  147.            Send COMMAND to the receiver for    execution, return with
  148.            COMMAND's exit status.
  149.       dddd    Change all instances of "." to "/" in the transmitted
  150.            pathname.  Thus,    C.omenB0000 (which is unacceptable to
  151.            MSDOS or    CP/M) is transmitted as    C/omenB0000.  If the
  152.            resultant filename has more than    8 characters in    the
  153.            stem, a "." is inserted to allow    a total    of eleven.
  154.       eeee    Escape all control characters; normally XON, XOFF, DLE,
  155.            CR-@-CR,    and Ctrl-X are escaped.
  156.       ffff    Send Full pathname.  Normally directory prefixes    are
  157.            stripped    from the transmitted filename.
  158.       iiii CCCCOOOOMMMMMMMMAAAANNNNDDDD
  159.            Send COMMAND to the receiver for    execution, return
  160.            Immediately upon    the receiving program's    successful
  161.            recption    of the command.
  162.       kkkk    (XMODEM/YMODEM) Send files using    1024 byte blocks
  163.            rather than the default 128 byte    blocks.     1024 byte
  164.            packets speed file transfers at high bit    rates.
  165.            (ZMODEM streams the data    for the    best possible
  166.            throughput.)
  167.       LLLL NNNN  Use ZMODEM sub-packets of length    N.  A larger N (32 <=
  168.            N <= 1024) gives    slightly higher    throughput, a smaller
  169.            N speeds    error recovery.     The default is    128 below 300
  170.            baud, 256 above 300 baud, or 1024 above 2400 baud.
  171.       llll NNNN  Wait for    the receiver to    acknowledge correct data every
  172.            NNNN (32 <=    N <= 1024) characters.    This may be used to
  173.            avoid network overrun when XOFF flow control is
  174.            lacking.
  175.       nnnn    (ZMODEM)    Send each file if destination file does    not
  176.            exist.  Overwrite destination file if source file is
  177.            newer than the destination file.
  178.       NNNN    (ZMODEM)    Send each file if destination file does    not
  179.            exist.  Overwrite destination file if source file is
  180.            newer or    longer than the    destination file.
  181.       oooo    (ZMODEM)    Disable    automatic selection of 32 bit CRC.
  182.       pppp    (ZMODEM)    Protect    existing destination files by skipping
  183.            transfer    if the destination file    exists.
  184.       qqqq    Quiet suppresses    verbosity.
  185.       rrrr    (ZMODEM)    Resume interrupted file    transfer.  If the
  186.            source file is longer than the destination file,    the
  187.            transfer    commences at the offset    in the source file
  188.            that equals the length of the destination file.
  189.       rrrrrrrr   As above, but compares the files    (the portion common to
  190.            sender and reciever) before resuming the    transfer.
  191.       tttt ttttiiiimmmm
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 7/3/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.            Change timeout to _t_i_m tenths of seconds.
  207.       uuuu    Unlink the file after successful    transmission.
  208.       wwww NNNN  Limit the transmit window size to N bytes (ZMODEM).
  209.       vvvv    Verbose causes a    list of    file names to be appended to
  210.            /tmp/szlog .  More v's generate more output.
  211.       yyyy    Instruct    a ZMODEM receiving program to overwrite    any
  212.            existing    file with the same name.
  213.       YYYY    Instruct    a ZMODEM receiving program to overwrite    any
  214.            existing    file with the same name, and to    skip any
  215.            source files that do have a file    with the same pathname
  216.            on the destination system.
  217.       ZZZZ    Use ZMODEM file compression to speed file transfer.
  218.  
  219.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  220.       ZZZZMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    DSZ/ZCOMM/Professional-YAM)
  221.       %%%% sssszzzz ----aaaa ****....cccc
  222.       This single command transfers    all .c files in    the current
  223.       Unix directory with conversion (----aaaa) to end of    line
  224.       conventions appropriate to the receiving environment.     With
  225.       ZMODEM AutoDownload enabled, Professional-YAM     and ZCOMM
  226.       will automatically recieve the files after performing    a
  227.       security check.
  228.  
  229.       %%%% sssszzzz ----YYYYaaaannnn ****....cccc    ****....hhhh
  230.       Send only the    .c and .h files    that exist on both systems,
  231.       and are newer    on the sending system than the corresponding
  232.       version on the receiving system, converting Unix to DOS text
  233.       format.
  234.  
  235.       ZZZZMMMMOOOODDDDEEEEMMMM CCCCoooommmmmmmmaaaannnndddd DDDDoooowwwwnnnnllllooooaaaadddd (Unix    to Professional-YAM)
  236.        cpszall:all
  237.           sz -c "c:;cd /yam/dist"
  238.           sz -ya $(YD)/*.me
  239.           sz -yqb y*.exe
  240.           sz -c "cd    /yam"
  241.           sz -i "!insms"
  242.       This Makefile    fragment uses sssszzzz to issue commands to
  243.       Professional-YAM to change current disk and directory.
  244.       Next,    sssszzzz transfers the ._m_e files from    the $YD    directory,
  245.       commanding the receiver to overwrite the old files and to
  246.       convert from Unix end    of line    conventions to PC-DOS
  247.       conventions.    The third line transfers some ._e_x_e files.  The
  248.       fourth and fifth lines command Pro-YAM to change directory
  249.       and execute a    PC-DOS batch file _i_n_s_m_s    . Since    the batch file
  250.       takes    considerable time, the ----iiii form is used to allow    sssszzzz to
  251.       exit immediately.
  252.  
  253.       XXXXMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    Crosstalk)
  254.       % ssssxxxx ----aaaa ffffoooooooo....cccc
  255.       EEEESSSSCCCC
  256.       rrrrxxxx ffffoooooooo....cccc
  257.       The above three commands transfer a single file from Unix to
  258.  
  259.  
  260.  
  261.      Page 4                          (printed 7/3/91)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.       a PC and Crosstalk with _s_z translating Unix newlines to DOS
  273.       CR/LF.  This combination is much slower and far less
  274.       reliable than    ZMODEM.
  275.  
  276.      EEEERRRRRRRROOOORRRR MMMMEEEESSSSSSSSAAAAGGGGEEEESSSS
  277.       "Caught signal 99" indicates the program was not properly
  278.       compiled, refer to "bibi(99)"    in rbsb.c for details.
  279.  
  280.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  281.       rz(omen), ZMODEM.DOC,    YMODEM.DOC, Professional-YAM,
  282.       crc(omen), sq(omen), todos(omen), tocpm(omen), tomac(omen),
  283.       yam(omen)
  284.  
  285.       Compile time options required    for various operating systems
  286.       are described    in the source file.
  287.  
  288.      FFFFIIIILLLLEEEESSSS
  289.       32 bit CRC code courtesy Gary    S. Brown.
  290.  
  291.       sz.c,    crctab.c, rbsb.c, zm.c,    zmodem.h Unix source files
  292.  
  293.       /tmp/szlog stores debugging output (sz -vv)
  294.  
  295.      TTTTEEEESSSSTTTTIIIINNNNGGGG FFFFEEEEAAAATTTTUUUURRRREEEE
  296.       The command "sz -T file" exercises the AAAAttttttttnnnn sequence error
  297.       recovery by commanding errors    with unterminated packets.
  298.       The receiving    program    should complain    five times about
  299.       binary data packets being too    long.  Each time sssszzzz is
  300.       interrupted, it should send a    ZDATA header followed by
  301.       another defective packet.  If    the receiver does not detect
  302.       five long data packets, the AAAAttttttttnnnn sequence is not
  303.       interrupting the sender, and the MMMMyyyyaaaattttttttnnnn string in sssszzzz....cccc must
  304.       be modified.
  305.  
  306.       After    5 packets, sssszzzz stops the    "transfer" and prints the
  307.       total    number of characters "sent" (Tcount).  The difference
  308.       between Tcount and 5120 represents the number    of characters
  309.       stored in various buffers when the Attn sequence is
  310.       generated.
  311.  
  312.      NNNNOOOOTTTTEEEESSSS
  313.       _S_z is    not designed be    called from _c_u(_1) or other outdial
  314.       communications programs.  Unix flavors of Omen Technology's
  315.       Professional-YAM communications software are available for
  316.       dial-out applications.
  317.  
  318.       When using TrailBlazer or other buffered modems at high
  319.       speed, particular attention must be paid to flow control.
  320.       The modem and    Unix must agree    on the flow control method.
  321.       Sz on    USG (SYS III/V)    systems    uses XON/XOFF flow control.
  322.       If flow control cannot be properly set up, Try a "-w 2048"
  323.       option to enforce protocol level flow    control.  Experiment
  324.  
  325.  
  326.  
  327.      Page 5                          (printed 7/3/91)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  335.  
  336.  
  337.  
  338.       with different window    sizes for best results.
  339.  
  340.       Telebit modems must not be set to "spoof" UUCP, XMODEM, or
  341.       KERMIT.  Setting one of these    spoofing modes interferes with
  342.       other    protoocls.
  343.  
  344.       If a program that does not properly implement    the specified
  345.       file transfer    protocol causes    _s_b to "hang" the port after a
  346.       failed transfer, either wait for _s_b to time out or keyboard
  347.       a dozen Ctrl-X characters.  Every reported instance of this
  348.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  349.       other    program    with a correct implementation of the specified
  350.       protocol.
  351.  
  352.       Many programs    claiming to support YMODEM only    support    XMODEM
  353.       with 1k blocks, and they often don't get that    quite right.
  354.       XMODEM transfers add up to 127 garbage bytes per file.
  355.       XMODEM-1k and    YMODEM-1k transfers use    128 byte blocks    to
  356.       avoid    extra padding.
  357.  
  358.       YMODEM programs use the file length transmitted at the
  359.       beginning of the transfer to prune the file to the correct
  360.       length; this may cause problems with source files that grow
  361.       during the course of the transfer.  This problem does    not
  362.       pertain to ZMODEM transfers, which preserve the exact    file
  363.       length unconditionally.
  364.  
  365.       Most ZMODEM options are merely passed    to the receiving
  366.       program; some    programs do not    implement all of these
  367.       options.
  368.  
  369.       Circular buffering and a ZMODEM sliding window should    be
  370.       used when input is from pipes    instead    of acknowledging
  371.       frames each 1024 bytes.  If no files can be opened, sssszzzz sends
  372.       a ZMODEM command to echo a suitable complaint; perhaps it
  373.       should check for the presence    of at least one    accessible
  374.       file before getting hot and bothered.
  375.  
  376.       A few    high speed modems have a firmware bug that drops
  377.       characters when the direction    of high    speed transmissson is
  378.       reversed.  The environment variable ZNULLS may be used to
  379.       specify the number of    nulls to send before a ZDATA frame.
  380.       Values of 101    for a 4.77 mHz PC and 124 for an AT are
  381.       typical.
  382.  
  383.      BBBBUUUUGGGGSSSS
  384.       On at    least one BSD system, sz would abend it    got within a
  385.       few kilobytes    of the end of file.  Using the "-w 8192" flag
  386.       fixed    the problem.  The real cause is    unknown, perhaps a bug
  387.       in the kernel    TTY output routines.
  388.  
  389.       The test mode    leaves a zero length file on the receiving
  390.  
  391.  
  392.  
  393.      Page 6                          (printed 7/3/91)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  401.  
  402.  
  403.  
  404.       system.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                          (printed 7/3/91)
  460.  
  461.  
  462.  
  463.